home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 45 / Amiga Format CD45 (1999-09)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-11].iso / +system+ / tools / expert / libguide / register / libguideline.english < prev    next >
Text File  |  1999-06-14  |  4KB  |  94 lines

  1. *****************************************************************************
  2. *                                                                           *
  3. *                           »Library Guidelines«                            *
  4. *                                                                           *
  5. *****************************************************************************
  6.                                1. Introduction
  7. Amiga at this point in time has no anchor or company support which could
  8. handle occuring or recurring problems. In this document we will try to bring
  9. out one problem which comes to our attention  - namely:
  10.  
  11.            The naming and installation of Amiga shared libraries.
  12.  
  13. Should a suitable company appear on the horizon in the future or near future
  14. which is interested in the development of the Amiga, this document will be
  15. then sent to them in the hope that the company will manage the things we
  16. mention herewith.
  17.  
  18. As long as there is no such company 
  19.               Heiko Schroeder - <age@thepentagon.com>
  20.  
  21. who handles "The largest AMIGA shared libraries guide" will act as a 
  22. substitute regarding these guidelines for the company we all hope will take 
  23. over Amiga and hopefully take an interest in it.
  24.  
  25.                         2. Library naming guidelines
  26. - Each Amiga shared library must have an unique name to avoid mistakes which
  27.   might end up in crashing software. To reach this goal it is required that
  28.   each library name must be registered.
  29.  
  30.   The registration can be done via:
  31.  
  32.   WWW       : http://...      (not available at this moment)
  33.  
  34.   EMail     : Heiko Schroeder - <age@thepentagon.com>
  35.               Subject: Library registration
  36.  
  37.   Snail mail: Heiko Schroeder
  38.               Arnoldstr. 1
  39.               04299 Leipzig
  40.               GERMANY
  41.  
  42.          Please use the registration form for email and snail mail!
  43.   On the Libraries WWW Page you can also search for existing names!
  44.  
  45. - Library names should always identify the functionality of the library.
  46.   Application specific libraries should start with the name or grammar
  47.   of the application and a name that also covers the functionality of the
  48.   library.
  49.  
  50.                          3. Installation guidelines
  51.  - Universal usable libraries which are distributed with Autodocs and as
  52.    a minimum the C-Interface file are allowed to be installed within "Libs:".
  53.    It is preffered to distribute libraries with interfaces for the following
  54.    languages:
  55.    * C
  56.    * Assembler
  57.    * Amiga-E
  58.    * Modula-II
  59.    * Oberon
  60.  
  61.  - Big library systems like MUI, XPK etc. should always be installed within
  62.    their own directory tree (like MUI did) and then do an
  63.    'assign add LIBS: MUI:Libs' within the "user-startup" file.
  64.    This will allow an easier uninstallation of such systems.
  65.  
  66.  - Application specific libraries and libraries without an interface/Autodocs
  67.    must always be installed within "PROGDIR:Libs/"
  68.  
  69.                                  4. Summary
  70. Library authors who are not following these guidelines will be requested to
  71. follow these guidelines. When they ignore such a request, their libraries will
  72. be declared as illegal by putting them onto a black-list.
  73. As a result from being on the black-list such a library will not longer be
  74. distributable via Aminet, Meeting Pearls etc.
  75.  
  76. *****************************************************************************
  77.  
  78. written by:
  79.  
  80. -------------------------------------------------------------------
  81. Kai Hofmann             EMail: i07m@informatik.uni-bremen.de
  82. FB 3, Informatik        WWW  : http://www.informatik.uni-bremen.de/~i07m/
  83. Universität Bremen      IRC  : PowerStat
  84. -------------------------------------------------------------------
  85.